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The  documentation  on  the  System  and  Software  Simulator  (S3) 
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DA-49-083  OSA-3306  and  contain  the  technical  descriptions  of  S3. 
Volume  I  describes  the  inputs,  outputs,  methods  and  capabilHies 
of  S3.  Volume  II  contains  the  flowcharts,  narrative  description  of  the 
flowcharts,  layouts  and  descriptions  of  the  tables  utilized  by  S3. 

Volumes  III  and  IV  contain  the  documentation  delivered  as  contract 
end  items  under  contract  number  DAAB09-68-C-0 1 18.  Volume  III 
contains  descriptions  of  the  assembly  language  used  for  prepax ation  of 
input  to  S3,  of  the  macro  capability  of  the  assembler,  and  of  the 
modifications  made  to  S3  to  provide  additional  output  data.  Volume  IV 
is  the  program  documentation  on  the  internal  workings  of  the  assembler. 
It  consists  of  table  descriptions,  flow  charts  and  narratives,  and  file 
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INTRXUCTION 

This  programmer’s  manual  contains  the  doc¬ 
umentation  for  the  internal  workings  of  the  S3  assembler. 

The  documentation  consists  of  table  descriptions, 
flow  charts  and  narratives,  and  file  descriptions  v.hich 
will  be  found  in  Section  I,  Section  II,  and  Section  III 
respectively. 
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SECTION  I 

TABLE  DESCRIPTIONS 
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TABLE  DESCRIPTIONS 


FORTR.^N  TABLE 

DESCRIPTION 

ITl  (100) 

GENERAL  ASSEMBLER  T/^LE 

AT2  (l)-(80) 

PRIMARY  INPUT  AREA  (CHAR) 

AT2  (81)-(94) 

PRIMARY  INPUT  AREA  (WORD) 

IT3  (175) 

FIX  FIELDS  OUTPUT  AREA 

IT4  (800,5) 

GLOBAL  DICTIONARY 

IT5  (800,5) 

LOCAL  DICTIONARY 

IT6  (90) 

GLOBAL  HASH  TABLE 

IT7  (90) 

LOCAL  HASH  TABLE 

IT8  (175) 

MACRO  PROTOTYPE  AREA 

IT9  (14) 

CUR  OUTPUT  AREA 

ITIO  (9) 

SECOND  PASS  OUTPUT  AREA 

ITll  (100,9) 

SECOND  PASS  TABLE 

IT12  (14) 

TITLE  iXREA 

IT13  (44,5) 

CPU-DEF  TABLE 

ITU  (9,30) 

MEM’DEF  TABLE 

IT15  (9,50) 

CHAN-DEF  TABLE 

IT16  (13,50) 

DEVICE -DEF  TABLE 

FORTRAN  TABLE 


DESCRIPTION 


IT17  (3,5) 
IT18  (8,30) 
IT19  (8,50) 
IT20  (12,50) 
IT21  (13,100) 
IT22  (16) 

IT23  (5,30) 
IT24  (8,150) 
IT25  (80) 

IT26  (5,16) 
IT27  (5,6) 
IT28  (25) 

IT29  (10) 

IT30  (3,100) 
IT31  (22,5) 
IT32  (3,150) 
IT33  (3,100) 
IT34X  (4,200) 
IT35  (10) 


CPU  CONFIGURATION  TABLE 
MEMORY  CONFIGURATION  TABLE 
CHANNEL  CONFIGURATION  TABLE 
CONTROL  CONFIGURATION  TABLE 
DEVICE  CONFIGURATION  TABLE 
TO-FROM  TABLE 
QTABLE 

REAL  FILE  TABLE 

INPUT-LEFT  JUSTIFIED  BY  CHARACTER 

LOAD  CLASS  TABLE 

RUN  CLASS  TABLE 

TABLE  DUMP  CONTROL  TABLE 

STATISTICS  CONTROL  TABLE 

PROGRAM  DISTRIBUTION  TABLE 

INTERRUPT  VECTOR  TABLE 

OP-CODE  TABLE 

JOB  NAME  TABLE 

ORDINAL  FILE  NAME  TABLE 

0/S  MEMORY  ALLOCATION  TABLE 


5 


ERROR  CODE  RANGES 


100  ASMl  -  PASS  1 

200  PLSYM,  GLSYM,  PGSYM,  GGSYM 

300  ASM2  -  PASS  2 

400  HARDWARE  DEFINITIONS 

500  FIX  FIELDS 


600 


SYSTEM  PARAMETERS 


TABLE  1  -  GENERAL  ASSEMBLER  TABLE 

Table  1  contains  all  one  word  variables  which 
are  referenced  in  two  or  more  subroutines. 

A  description  of  each  field  in  table  1  can  be 
found  starting  on  the  next  paoe. 


ITl(l) 

IT1(2) 

IT1(3) 

IT1(4) 

IT1(5) 
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GENERAL  ASSEMBLER  TABLE 


ISWl 

SUBROUTINE  SA4  (FIX  FIELDS  ROUTINE) 
RETURN  CODE 

1  =  COMMENTS  CARD 

2  =  NORMAL  STATEMENT 

3  =  CONTINUATION  REQUIRED 

ISW2 

MACRO  DEFINITION  SWITCH 

0  s  NO  MACRO  DEFINITION  IN  PROGRESS 
1  =  MACRO  DEFINITION  IN  PROGRESS 
MACNBR 

CURRENT  MACRO  SUFFIX  VALUE 
N 

CURRENT  INPUT  CHARACTER  BEING  EXAMINED 
CPSW 

OPERAND  SWITCH 

0  -  NO  M3RE  OPERANDS 


1  -  ADDITIONAL  OPERANDS 


1X1(6)  STNBR 


CURRENT  STATEMENT  N'UMBER 
1X1(7)  MIN 

MACRO  INPUT  SW 

0  =:  NOTHING  ON  MACRO  INPUT  FILE 
1  =  DATA  ON  MACRO  INPUT  FILE 
Ij-I(S)  _NGF  INITIAL  VALUE  =  1 

NUMBER  OF  NEXT  FREE  ENTRY  IN  LOCAL 
SYMBOL  TABLE 

1X1(9)  INITIAL  VALUE  s  1 

NUMBER  OF  NEXT  FREE  ENTRY  IN  LOCAL 
SYMBOL  TABLE 

XXI  (10)  W  INITIAL  VALUE  ==  800 

MAXIMUM  NUMBER  OF  ENTRIES  IN  GLOBAL 
SYMBOL  TABLE 

1X1(11)  ^  INITIAL  VALUE  =  800 

MAXIMUM  NUMBER  OF  ENTRIES  IN  LOCAL 
SYMBOL  TABLE 


COPY  INPUT  SWITCH 


0  =  NOTHING  ON  COPY  INPUT  FILE 
1  =  DATA  ON  COPY  INI’UT  FILE 

in  (13)  PEOF 

PRIMARY  INPUT  (CARD  READER) 

END  OF  FILE  SWITCH 

0  =  NO  END  OF  FILE 
1  s  END  OF  FILE 

IT1(14)  CEOF 

COPY  END  OF  FILE  SWITCH 
0  =  NO  END  OF  FILE 
1  =  END  OF  FILE 

IT1(15)  MEOF 

MACRO  END  OF  FILE  SWITCH 
0  =  NO  END  OF  FILE 
1  =  END  OF  Fir^ 

IT1(16)  ISW3 

RESOLVE  OP-CD  OUTPUT  SWITCH 
0  a  NORMAL  OP-CD 

1  a  SPECIAL  OP-CD 

2  a  UNRESOLVED  OR  MACRO  OP-CD 


IT1(17)  lASM 

ASSEMBLY  STATEMENT  SWITCH 
0  =  NOT  RECEIVED 
1  =  RECEIVED 

IT1(18)  OPCD 

CURRENT  OPERATION  CODE 
IT1(19)-IT1(23) 

NEXT  EXPECTED  OP -CD  TABLE 

IT1(24)  BLANKS  INITIAL  VALUE  =  6  BLANKS 

IT1(25)  CURUNT  INITIAL  VALUE  =  15 

UNIT  FOR  CUR  OUTPUT  TAPE 
IT1(26)  SEQCHK 

SEQUENCE  CHECKING  COUNTER  FOR  SECOND  PASS 
IT1(27)  NWR 

NUMBER  OF  WORKER  POUTINE  CURRENTLY  BEING 
PROCESSED 
IT1(28)  ERRSW 

ERROR  SWITCH 

0  s  CURRENT  STATEMENT  HAS  NO  ERROR 
1  a  CURRENT  STATEMENT  HAS  AN  ERROR 


IT1{29) 

IT1{30) 

1X1(31) 

I 

1X1(32) 

1X1(33) 

1X1(34) 

1X1(35) 

1X1(36) 

1X1(37) 

m(3&) 


•  it 


c- 


ILNCX 

NUMBER  OF  LINES  LEFX  ON  CURRBNX  PAGE 
IPGCX 

CURRENX  PAGE  COUNT 

MACINP  INIXIAL  VALUE  =  10 

CURRENX  MACRO  INPUX  FILE 

MACQPX  INIXIAL  VALUE  =11 

CURRENX  MACRO  OUXPUX  FILE 

ICPUD 

CPU  DEFINIXION  COUNTER 
ICFACX  , 

ADJUSTMENT  FACTOR  FOR  COMPUTE  STATEMENTS 
I  MEND 

MEMORY  DEFINIXION  COUNTER 
ICHANP 

CHANNEL  DEFINIXION  COUNTER 
ICHCT 

CHANNEL  TABLE  ENTRY  COUNTER 
PRTSW 

0  «  Dav*T  PRINT  SECOND  PASS  OUTPUT 


1  *  PRINT  SECOND  PASS  OUTPUT 


IT1(39) 

IT1(40) 

IT1(41) 

IT1(42) 

IT1(43) 

IT1(44) 

IT1(45) 

IT1(46) 

IT1(47) 

IT1{48) 


JSTNBR 

JOB  STATEMENT  NUMBER 
ICQNl 

CPU  CONFIGURATION  COUNTER 
IC0N2 

MEM  CONFIG  CTR 
ICQN3 

CHAN  CONFIG  CTR 
IC0N4 

CTL  CONFIG  CTR 
ICONS 

DEV  CONFIG  CTR 
ITFP 

TO-FROM  TABLE  IN  PROGRESS  SW 
IROW 

CURRENT  TO-FROM  ROW 
INFL 

NUMBER  TO-FROM  FILES 
IDEV 


simMSW 


DEVICE  #  FOR  CURRENT  TO-FROM  TABLE 


IT1(49)  I^ER 
IT1(50)  IQR 

QUEUE  DEFINITION  SIVITCH 

0  =  Q-DEF  NOT  RECEIVED 

1  =  Q-DEF  RECEIVED 

2  =  Q-END  RECEIVED 

IT1(51)  IQCTR 

QUEUE  COUNTER 
IT1(52)  IQENT 

QUETJE  ENTRY  COUNTER 
IT1(53)  MULT 

COMPUTE  MULTIPLICATION  FACTOR 
IT1(54)  NSUM 

HASH  VALUE  OF  SYMBOL 
IT1(55)  IFLR 

FILE  DEFINITION  CONTROL  SW 
0  =  FILES  NOT  RECEIVED 
1  =  FILES  BEING  RECEIVED 


2  --  FILES  RECEIVED 


IFIjCTR 


IT1(56) 

REAL  FILE  COUNTER 

IT1(57) 

LOAD  CLASS  CONTROL  SW 

0  =  LOAD  CLASS  LOT’  RECEIVED 

1  =  LOAD  CLASS  BEING  RECEIVED 

2  =  LOAD  CLASS  RECEIVED 

IT1(58)  IRCR 

RUN  CLASS  CONTROL  SW 

0  =  RUN  CLASS  NOT  RECEIVED 

1  =  RUN  CLASS  BEING  RECEIVED 

2  =  RUTS[  CLASS  RECEIVED 

IT1(59)  ITA3 

TABLE  DUMP  CONTROL  SW 

0  =  TABLE  DU>P  CTL  NOT  RECEIVED 
1  =  TABLE  DUMP  CTL  RECEIVED 

IT1(60)  ISTAT 

STATISTICS  CONTROL  SW 

0  =  STATISTICS  CONTROL  NOT  RECEIVED 
1  =  STATISTICS  CONTROL  RECEIVED 


IT1(61)  KINT 


STATISTICS  INTERVAL  RECEIVED  SW 
0  =  NOT  RECEIVED 
1  =  RECEIVED 

IT1(62)  JOBSW 

JOB  SWITCH 

0  =  NO  JOB  IN  PROGRESS 
1  =  JOB  IN  PROGRESS 
IT1(63)  JOBCTR 

JOB  COUNTER 
IT1(64)  OFCTR 

ORDINAL  FILE  COUNTER 
IT1(65)  MINP 

MORE  INPUT  SWITCH  USED  IN  SMACRO 
0  =  OFF 
1  =  ON 

IT1(66)  ANPS 

ANOTHER  PASS  SWITCH  USED  IN  SMACRO 
0  =  OFF 
1  =  ON 

IT1(67)  HIMAC 

HIGH  MACRO  NBR  COUNTER  USED  IN  SMACRO 


IT1(6S)  ERFIL 


IT1(69) 


Ill (70) 


IT1(71) 


CURRENT  FORTRAN  UNIT  NUMBER  FOR  ERROR  OUTPUT 
OFCTR 

ORDINAL  FILE  COUNTER 
KCOUNT 

NUMBER  OF  STATISTICAL  INTERVALS  FOR  SIMULATION 
STSVJ 

STORE  SWITCH 

0  =  NO  STORE  IN  PROGRESS 
1  =  STORE  IN  PROGRESS 


r 


7 


TABLE  2  -  PRIMARY  INPUT  AREA 


Table  2  is  divided  into  two  sections.  The 
first  80  words,  AT2(1)  to  AT2(80),  contain  80  characters 
as  read  from  the  current  input  source.  Each  word  con¬ 
tains  one  character  left  justified  and  right  filled 
with  blanks.  The  second  section  of  table  2  consists  of 
14  words,  AT2(81)  to  AT2(94).  The  firSi  13  words  of 
this  section  contain  six  characters  each  and  the  14xh 
word  contains  two  characters  left  justified  and  right 


filled  with  blanks 


TABLE  3  -  FIXED  FIELDS  OUTPUT  /J?EA 


Table  3  is  the  area  used  to  store  the  output 
from  the  fix  fields  routine  (SA4,  SA5).  Word  1  is  not 
normally  used.  Word  2  contains  the  total  number  of 
operands  in  this  statement  in  the  first  12  bits.  Word  2 
also  contains  the  two  character  statement  variable,  if 
any,  in  the  last  12  bits.  Words  3  and  4  contain  up  t o 
12  characters  of  the  statement  label.  Word  5  contains 
the  length  of  the  statement  label  in  the  first  6  bits. 

The  next  12  bits  are  used  to  hold  a  code  which  indicates 
if  the  label  is  fixed  or  variable.  Labels  may  be  var¬ 
iable  only  when  a  macro  definition  is  in  progress.  The 
next  12  bits  contain  a  code  which  indicates  if  a  macro 
number  is  to  be  appended  to  the  label.  This  code  may 
be  set  only  if  a  macro  definition  is  currently  in  progress. 
Words  6  and  7  contain  up  to  12  characters  of  operation 
code.  Word  8  contains  the  length  of  the  operation  code 
in  the  first  6  bits.  The  next  12  bits  contain  a  code 


which  indicates  if  the  operation  code  is  fixed  or  var¬ 
iable.  Variable  operation  codes  are  permitted  only  in 
macro  definitions.  Words  9  and  10  contain  up  to  12 
characters  of  the  first  operand  for  this  statement. 
Word  11  contains  the  length  of  the  first  operand  in 
the  first  6  bits.  The  next  12  bits  contain  a  code 
which  indicates  if  the  first  operand  is  fixed  or  var¬ 
iable.  The  next  12  bits  indicate  whether  a  macro 
number  should  be  appended  to  this  operand  or  not.  The 
remainder  of  table  3  consists  of  three  word  units  each 
of  which  is  used  to  describe  a  single  operand.  A 
maximum  of  55  operands  may  be  accomodated  by  table  3. 


TABLE  3 


FIXED  FIELDS  OUTPUT  AREA 


(VORD  ’6  bits 


3 

4 


i  6  bits 


6  bits  !  6  bits 


6  bits 


’6  bits 


NOT  USED 


i  NUMBER  OF  OPERANDS 


1 

jsTATENENT  VFJ^IASLE 


LABEL 


PART  I 


LABEL 


:T  II 


5 

;  LABEL 
■  LENGTH 

0  =  FIXED  LABEL 

N  =  VARIABLE  LABEL 

jO  =  NO  MACRO  # 

[99  =  ADD  MACRO  # 

0  1 

6 

OP-CD 

PART  I 

7 

‘ 

OP-CD 

PART  II 

i 

8 

OP-CD 
!  LENGTH 

0  =  FIXED  OP-CD 

99  =  VARIABLE  OP-CD 

i 

i.  ..  ....  . 

- [ 

0  I 

9 

OPERAND-! 

PART  I 

1 

10 

OPERAND-1 

PART  II 

i 

\ 

1 

lx 

OPERAND -1 

-  r.ENGTH 

0  =  FIXED  OPERAND 

99  =  VAR  I  ABLE  ...OPERAND.: 

i  0  =  NO  MACRO  fff 
i  OQ  =  ADD  MACRO  # 

\ 

i 

0 

\ 

1 

1 

i' 

171 

OPERAND  55 

PART  I 

f 

j 

172 

OPERAND  55 

PART  II 

i 

i 

173 

■  0  ERAND.55  j 
LENGTH  1 

i  0  =  FIXED  OPERAND  | 

1  99  =  VARIABLE  OFiiRAND  1 

0  =  NO  MACRO 

99  =  /DD  MACRO 

- ( 

.  =  i 

TABLE  4  -  GLOBAL  DICTIONARY 


The  Global  Dictionary,  table  4,  can  contain 
up  to  800  five  word  entries.  Each  entry  is  used  to 
describe  a  single  global  symbol.  The  following  page 
describes  the  various  types  of  symbols  which  may  be 
found  in  the  global  symbol  table. 

The  first  two  words  of  a  Global  Dictionary 
entry  contain  up  to  12  characters  of  the  symbol.  The 
3xd  word  of  an  entry  con  '■ains  the  type  of  symbol  as 
described  on  the  following  page.  The  4th  word  of  an 
entry  contains  the  value  which  has  been  assigned  to  this 
symbol.  The  5th  word  of  an  en\ry  may  contain  a  pointer 
to  subsequent  entries  on  this  ch^in  in  the  Clobal  Diction¬ 
ary.  For  a  brief  description  of  th=  use  of  table  4  see 
the  PGSYM,  GGSYM,  and  the  HASH  subroutine  descriptions. 


GLOBAL  SYMBOL  TABLE  TYPES 


TYPE 

1 

2 


3 

4 

5 

6 


7 

S 

9 

10 


DESCRIPTION 

AT  =  1 
lOT  =  2 

LIB  =  1 
NCAT  =  2 
CAT  =  3 

cpu-name 

meia-nanes 

chan-name 

IN  =  1 
OUT  =  2 
I/O  =  3 

ctl-names 

SEIZE  =  1 
NCSEIZE  =  2 

dev -names 

quGue-nar.es 

NOT  USED 


0 


TYPE 

DESCRIPTION 

13 

real “Z i le -name  s 

14 

function-names 

15 

global -equates 

16 

job -name 

17 

interrupt  -naimes 

TABLE  4 


GLOBAL  DICTIONARY 


V:ORD 


1 

;  SYMBOL 

PART  I  1: 

2 

.  SYMBOL _ _ 

PART  II 

3 

S^'^L . . 

TYPE  § 

'  SYMBOL 

VALUE 

5 

■  CHAIN 

INDEX  S 

--  . . -M — rrmr.^r.-t) 

o-rr 


TABLE  5  -  LOCAL  DICTIONARY 

The  Local  Dictionary  Ccin  contain  up  to  800 
symbols  as  defined  by  the  worker  routine  currently  in 
process.  Each  time  an  END  statement  is  encountered 
the  current  Local  Dictionary  is  written  out  to  FORTRAN 
unit  number  8,  amd  the  Local  Dictionary  xable  is  initial¬ 
ized  to  contain  zeroes.  The  Local  Dictionary  File  as 
contained  on  FORTRAN  unit  number  8  is  then  used  by  the 
second  pass  to  resolve  symbols  from  the  intermediate 
assembly  file. 

Words  1  and  2  for  an  entry  in  the  Local 
Dictionary  can  contain  up  to  12  characters  from  a 
local  symbol.  Word  3  contains  the  S5^inbol  type  as 
described  on  the  following  page.  Word  4  contains  the 
value  assigned  to  this  symbol.  Word  5  may  contain  a 
pointer  to  subsequent  entries  in  the  current  Local 
Dictionary  table .  For  a  complete  description  of  the 
use  of  the  Local  Dictionary  see  the  PLSYM,  GLSYM,  and 
HAJH  subroutine  descriptions. 


4 

! 


! 

i 

! 


LOCAL  SYMBOL  TABLE  TYPES 

DESCRIPTION 
statement -label 
ordinal -fi le -name 
local -eqiiate 


TABLE  6  -  GLOBAL  HASH  TABLE 

The  Global  Hash  Table  consists  of  90  words, 

all  of  which  are  initialized  to  zero  when  the  assembler 

/ 

is  loaded.  Wtien  a  symbol  is  to  be  entered  into  the 
global  symbol  table  a  value  from  1  to  90  is  calculated 
by  the  HASH  subroutine  from  the  characters  in  the  symbol 
to  be  placed  into  the  table.  That  address  is  then  used 
to  place  a  pointer  to  an  address  in  the  global  symbol 
table  into  the  global  hash  table.  ,  The  global  hash  table 
then  contains  pointers  to  entries  in  the  global  symbol 


TABLE  7 

LOCAL  HASH  TABLE- 


Table  8  is  used  to  store  the  label,  operation 
code,  and  operands  for  macro  calls  during  processing  by 
the  SMACRO  Subroutine.  Table  8  is  filled  by  copying  the 
current  entry  from  table  3.  Therefore,  table  8  is  an 
exact  duplicate  of  table  3. 


TABLE  8 

MACRO  PROTOTYPE  AREA 


bits 


6  bits  16  bits 


NOT  USED 


NUMBER  OF  OPERANDS 


i  K' 


!  6  bits 


LABEL 

LENGTH 


STATEMENT  VARIABLE  | 


LABEL 

.  FART 

I 

LABEL 

PART 

NOT  USED 


AME^ _ 


NOT  USED 


NOT  USED 


OPERAND -1  PART  I 


OPERAND -1  PART  II 


NOT  USED 


OPERAND'S 

LENGTH 


OPERAND  55  PART  I 


OPERAND  55  PART  II 


o^ 


TABLE  9  -  CURRENT  OUTPUT  AREA 

Table  9  consists  of  14  v)ords  used  to  build 
records  for  entry  into  the  PCF  library.  These  entries 
are  then  placed  on  the  GUI?  output  tape  by  means  of  the 
CUROUO'  subroutine.  Table  9  is  also  Used  to  store  14 
ivord  records  retrieved  from  the  library  by  means  of  the 
SRCHNV  and  xNXTIMT  subroutines. 

# 


TABLE  10  -  SECOND  PAS.^  OUTPtjT  AREA 

Table  10  consists  of  9  words  which  axe  used 
to  build  records  by  the  second  pass  for  output  to  the 
simulator*  The  first  word  of  this  table  contains  the 
current  worker  routine  number.  The  second  word  contains 
the  current  worker  routine  statement  number.  The  third 
word  contains  the  numeric  operation  code  for  this  state¬ 
ment.  Vtords  4  through  9  contain  the  numeric  values  for 
operands  1  through  6. 


o  / 


TABLE  II  -  5SCOXD  PASS  TABLE 

Table  11  consists  oc  a  nine  word  errtry  xor 
each  operation  code  which  is  capable  of  being  nsec  by 
the  simulator.  The  operation  code  value  is  used  as  an 
index  to  table  lx.  Therefore,  operation  code  1  would 
cause  the  second  pass  to  use  entry  1  in  table  11-  Ine 
nino  wirds  iu  each  entry  in  table  ii  are  used  to  control 
the  processing  perfomed  by  the  second  pass  on  each 
statement  before  it  is  written  out  for  use  by  the  sim¬ 
ulator.  Word  1  may  contain  •  ither  a  zero  or  a  nusber 
indicating  a  pre-process  is  required  for  the  current 
statenent,  An  example  ox  a  pre-process  would  be  se^^’  ance 
checking  a  JO'  >tateaent,  C?  statenent,  statenent, 

and  GEN  statenent.  VTord  2  contains  a  zero  or  a  nunber 
i?:dicating  that  post -processing  is  necessary  for  this 
statenent.  An  exanple  of  post -processing  would  be 
checking  to  inspire  that  a  SELECT  A^^QUEUEl  statenent 
refere.'ced  a  queue  which  contained  ATs. 


Kqxc  3  coiitalns  the  insxructioc  l^ngta  for 
rhe  currant  stateaeux'  as  usad  by  the  sixsulator.  This 
value  is  useii  to  salntain  a  current  location  counter 
tihich  is  printed  with  each  states:ent  if  the  PRIXT 
option  was  Sj^cifiec  in  the  ASSEJiELY  statement. 

Ivords  4  through  5  nay  contain  a  zero,  a  pos¬ 
itive  value,  or  a  negative  value.  These  words  control 
the  processing  for  operands  1  through  6  of  th^  current- 


the  operand  process  nusber  is  zero,  the 


cperanc  nust  be  daitted  and  any  operand  present  with 
that  nuhSer  will  be  flagged  as  an  error.  If  the  process 
r.unher  for  an  <»erand  is  positive  the  operand  nust  be 
included  and  the  nuhber  indicates  the  process  which  will 
be  used  to  convert  the  operand  into  an  output  value.  If 


a  process  nunber  for  an  operand  is  negative,  the  operand 
is  cptiouai.  lx  the  operand  is  present,  the  nuhber  ih- 
nicatas  the  process  which  is  to  be  usee  to  convert  the 
operand  to  an  output  value.  However,  if  the  operand  is 


no  6XXOX  aS 


TABLE  12  -  TITL5  ASSA 

Table  12  consists  of  14  words  wuicn  are  used 
to  store  the  page  title  os  specified  by  the  user.  When¬ 
ever  a  TITLE  stateaent  is  encountered  the  following  card 
is  read  into  table  12.  The  contents  of  this  table  are 
printed  at  the  top  of  each  page  by  the  PACS  subroutine. 


table  13  -  Cpg  DEFIXITIC^^  TABLE 

Table  ri3  contains  a  mcociiaum  of  five  44  word 
entries,  each  o£. which  completely  defines  a  CPU.  This 
table  is  filled  as  specified  by  the  CPU-DEF  statement. 
If  either  CAT  or  ?{CAT  are  specified,  this  'table  is 
filled  by  reading  from  the  current  input  stream.  If 
LIB-is  specified  this  table  is  filled  by  Obtaining  a 
■  CPU  definition  from  the  library.  Each  entry  in  this 
table  is  completely  described  by  the  following  table 
layikit. 


TABLE  14  -  MEM-DSR  TABLE 


The  Meinoiry  Definition  Table  may  contain  up 
to  a  maximum  of  30  nine  word  memory  definitions. 
Entries  in  the  memory  definition  table  are  filled  as 
specified  by  the  MEM-DEF  statement.  If  CAT  or  NCAT 
is  specified  the  memory  definition  table  is  filled 
from  the  current  input  stream.  If  LIB  is  specified 
the  memory  definition  table  entry  is  filled  on  the 
library.  Bach  word  of  an  entry  in  the  memory  defin¬ 
ition  table  is  described  in  the  following  table  layout 


nf*. 


TABLE  14 
MEM-DEF  TABLE 


TABLE  15  -  CHAN-DEF  TABLE 


The  Channel  Definition  Table  can  contain  up 
to  a  maximvuQ  of  fifty  9  word  channel  definitions.  Each 
entry  in  this  table  is  filled  as  specified  by  a  CHAN-DEF 
statement.  If  CAT  or  NCAT  is  specified  the  current 
entry  is  filled  from  the  current  input  source.  If  LIB 
is  specified,  tte  current  entry  is  filled  from  the  library. 
Each  word  of  a  Channel  Definition  entry  is  described  in 
the  folloifling  table  layout. 


TABLE  16  -  DEVICE-^DEF  TABLE 

The  Device  Definition  Table  is  capable  of 
containing  up  to  fifty  13  word  device  definitions. 

Each  entry  in  the  Device  Definition  Table  is  filled 
as  specified  by  the  DEV-DEF  statement.  If  CAT  or  NCAT 
is  specified,  the  current  entry  in  the  table  is  filled 
from  the  input  source.  If  LIB  is  specified  the  current 
entry  in  tbe  Device  Definition  Table  is  filled  from  the 
library.  Each  word  in  a.  devoc^definition  table  entry 
is  described  by  the  following  table  layout. 


TABLE  17  r  CPU  CONTIGORATION  TABLE 

Table  17  can  contain  up  to  five  entries,  each 
of  which  describes  a  CPU  for  the  current  simulation.  Each 
entry  in  ta^u.e  17  is  filled  as  specified  by  the  CPU  state¬ 
ment.  Words  1  and  2  contain  up  to  12  characters  of  the 
CPU-NAME.  word  3  contains  a  pointer  to  the  CPU  definition 
which  describes  this  CPU. 


TABLE  18  ~  MEMORY  CONFIGURATION  TABLE 

Table  18  can  contain  the  configuration  data 
for  up  to  30  memories.^  Each  entry  in  this  table  is 
filled  fxosa  the  data  supplied  with  a  statement. 
The  first  two  words  contain  up  to  12  characters  of 
the  Words  3  through  7  can  contain  CPU  num¬ 

bers  which  are  used  to  define  the  CPUs  to  which  this 
memory  is  attached .  Word  8  contains  the  index  of  the 
entry  in  the  memory  definition  table  which  describes 
the  physical  characteristics  of  this  memory.  Thie 
organization  of  a  single  entry  in  the  memory  config¬ 
uration  table  is  described  by  the  following  table 


layout 


-  ~  ^  -.-r  - 

-"A'i  J  •*=;' 

i  V  ‘r ' 
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TABLE  19  -  CHANNEL  CONFIGURATION  TABLE 


Th^e  Channel  Configuration  Table  can  contain 
the  configuration  data  for  up  to  50  channels.  The  infor¬ 
mation  for  each  entry  in  this  table  is  extracted  from  the 
CHANNEL  statement.  The  first  two  words  of  an  entry  con¬ 
tain  up  to  12  characters  of  the  CHAN-NAME.  Words  3 
through  7  can  contain  CPU  numbers  which  are  used  to 
indicate  the  CPUs  to  which  this  channel  is  attached. 

Word  8  contains  the  index  of  an  entry  in  the  channel 
definition  table  which  describes  the  physical  character¬ 
istics  of  this  channel.  A  complete  description  of  a 
channel  configuration  table  entry  is  given  by  the  following 
table  layout. 


.  TABUS  20  -  CONTROL  CONFIGURATION  TABLE 

The  Control  Configuration  Table  is  capable 
of  holding  the  configuration  data  for  up  to  50  control 
units.  Each  entry  in  this  table  is  filled  from  the 
information  obtained  from  a  CONTROL  statement.  The 
first  two  words  of  an  entry  in  this  table  contain  up 
to  12  characters  of  a  CTL-NAME.  The  third  word  con¬ 
tains  a  code  which  indicates  whether  this  control  unit 
is  capable  of  handling  INPUT,  OUTPUT,  or  INPUT  and 
OUTPUT  operations.  Words  4  through  12  may  contain 
channel  numbers  indicating  those  channels  to  which  this 
control  unit  is  attached.  A  detailed  description  of 
each  table  entry  for  the  control  configuration  table 
is  provided  by  the  following  table  layout. 


TABLE  20 


CONTROL  CONFIGURATION  TABLE 


CTL-NAME  PART  I 

CTL-NAMS  PART  II 

I-O-I/O  CODE 
CHAN-#  INDEX _ 


TABLE  21  -  DEVICE  CONFIGORATION  TABLE 


The  Device  Configuration  Table  is  capable  of 
containing  configuration  Hata  for  up  to  100  devices. 

The  configuration  data  for  each  entry  in  the  device 
configuration  tablo  comes  from  a  DEVICE  statement. 

The  first  two  words  contain  up  to  12  characters  of  the 
DEV-NAME.  Word  3  contains  a  code  which  indicates  if 
this  device  is  seizable  or  not.  Words  4  through  12 
may  contain  a  control  nvimber,  indicating  those  control 
units  to  whir'i  this  device  is  attached.  Word  13  con* 
tains  the  number  of  the  entry  in  the  device  definition 
table  which  describes  the  physical  characteristics  of 
this  device.  A  complete  der.cription  of  an  entry  in  the 
device  configuration  table  is  supplied  in  the  following 


table  layout 


5S 


TABLE  22  -  10-PRGM  TABLE 


The  To-FroB  Table  contadLns  enough  roca  to 
build  a  single  entry  in  the  to-froa  table.  As  each 
entry  is  built,  it  is  written  out  to  the  simulator 
input  file.  Word  1  contains  the  device  number  for 
which  this  to-from  table  is  being  built.  Word  2  con¬ 
tains  the  nuiBber  of  the  row  currently  being  descrdbed. 
Word  3  contains  the  dimensions  of  this  to-from  array. 
Words  4  through  16  contain  the  13  possible  entries  in 
a  to-from  table.  A  complete  description  of  a  single 
entry  in  the  to-from  table  is  given  by  the  following 
table  layout . 


TABLE  22 


TO 

-FROM  TABLE 

WCKD 

1 

DEV-# 

2 

TO  ROW 

3 

AR’’  '  Y 

DIMENSION 

4 

ENTRY 

1 

. 

5 

ENTRY 

2 

6 

■ 

1  ENTRY 

, 

3 

7 

1  ENTRY 

4 

8 

ENTRY 

5  1 

9 

ENTRY 

6  j 

10 

ENTRY 

7  1 

11 

ENTRY 

8  1 

12 

ENTRY 

9. _ _ 

13 

ENTRY 

10  j 

14 

ENTRY 

11  1 

15 

ENTRY 

12  j 

ENTRY  13 


TABLE  23  ~  QUEUE  TABLE 


The  Queue  Table  can  contain  up  to  30  queue 
definitions.  The  data  for  each  entry  in  the  queue  table 
is  obtained  from  the  QUEUE  statement.  The  first  two 
words  contain  up  to  12  characters  of  the  QUEUE-NAME.  The 
third  word  contains  the  maximum  number  of  entries  for  the 
queue.  The  fourth  word  contains  a  code  which  indicates 
whether  this  queue  can  contain  ATs  or  lOTs.  Word  5 
contains  a  code  to  indicate  whether  this  queue  should 
be  processed  as  a  FIFO,  LIFO,  or  PRI  type  queue.  A 
complete  description  of  a  single  entry  in  the  queue 
table  is  provided  by  the  following  table  layout. 


G2 


TABLE  23 
QUEUE  TABLE 


■NAME 


j^NAME 
MAX-NO-ENTRIES 


PART  I 


PART  II 


Q-CONTROL 


Q-METHOD 


TABLE  24  -  REAL  FILE  TABLE 


Table  24  can  contain  up  to  150  real  file 
definitions.  The  data  for  an  entry  in  the  real  file 
table  is  obtckined  from  the  RE  or  RFC  statements. 

Words  1  and  2  contain  up  to  12  characters  of  the  real 
file  name.  Word  3  contains  the  number  of  this  real  file. 
Word  4  contains  the  number  of  the  device  on  which  this 
real  file  resides.  Word  5  contains  the  relative  location 
of  this  file  on  the  device.  Word  6  contains  the  number 
of  characters  in  a  single  physical  record  in  this  file. 
Word  7  contains  the  number  of  logical  records  in  a  single 
physical  record  of  this  file.  Word  8  contains  the  total 
number  of  physical  records  in  this  file.  A  complete 
description  of  a  single  entry  in  the  real  file  table  is 
supplied  in  the  following  table  layout. 


65 


TABLE  25  -  INPUT  LEFT-JUSTIFIED  BY  CHARACTER 


Table  25  contains  80  characters  from  the 
current  input  record,  with  one  character  per  word, 
left  justified,  and  right  filled  with  blanks. 


TABLE  26  -  LOAD  CLASS  TABLE 


The  Load  Class  Table  is  capable  of  containing 
up  to  15  load  class  entries.  The  16th  entry  is  used 
to  temporarily  store  information  for  a  load  class  state¬ 
ment  in  which  an  error  has  been  found.  Each  entry  in 
the  load  class  table  may  contain  up  to  5  CPU  numbers. 

A  complete  description  of  a  load  class  table  entry  may 
be  found  in  the  following  table  layout. 


TABLE  27  -  RUN  CLASS  TABLE 


The  Run  Class  Table  is  capable  of  containing 
up  to  five  run  class  entries.  A  sixth  entry  is  pro¬ 
vided  to  temporarily  store  data  when  a  run  class  des¬ 
cription  has  been  fotind  to  contain  an  error.  Each 
entry  in  the  run  class  table  may  contain  up  to  5  CPU 
numbers.  A  complete  description  of  a  run  class  table 
entry  may  be  found  in  the  following  table  layout. 
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TABLE  28  -  TABLE  DUMP  CONTROL  TABLE 


Table  28  contains  25  words,  each  of  which  may 
be  set  to  control  the  printing  of  tables  contained  within 
the  simulator.  If  a  word  contains  a  zero,  the  corres¬ 
ponding  table  in  the  simulator  will  be  printed  at  the 
end  of  each  statistical  interval.  If  a  word  contains  a 
minus  1,  the  corresponding  table  in  the  simulator  will 
not  be  printed  at  the  end  of  a  statistical  interval.  A 
detailed  layout  for  table  28  may  be  found  on  the  following 


page 


TABLE  29  -  STATISTICS  CONTROL  TABLE 

The  Statistics  Control  Table  contains  10  words, 
each  of  which  may  be  used  to  control  the  printing  '•< 
statistics  in  the  simulator  at  the  end  of  simulation 
intervals.  If  a  word  contains  a  zero,  the  corresponding 
statistics  will  be  printed  at  the  end  of  each  statistical 
interval.  If  a  word  contains  a  minus  one,  the  corresponding 
statistics  will  not  be  printed  at  the  end  of  intervals. 

A  complete  description  of  the  Statistics  Control  Table 
may  be  found  in  the  following  table  layout. 


TABLE  29 


STATl 
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TABLE  30  -  PROGRAM  DISTRIBUTION  TABLE 

The  Program  Distribution  Table  can  contain 
program  distribution  information  for  up  to  100  worker 
routines.  This  table  is  normally  initialized  so  that 
each  program  is  received  by  CPU  1  and  has  a  load  class 
number  of  1.  If  a  program  is  to  be  handled  ir  some  v.’ay 
other  than  normal,  the  RCV  statement  must  be  used  in 
that  program.  The  RCV  statement  may  be  used  to  specify 
the  receiving  CPU  and  the  load  class  which  is  to  be  used 
for  that  program.  Word  1  of  each  entry  contains  the 
program  number.  The  second  word  contains  the  number  of 
the  receiving  CPU  for  that  program.  Word  3  contains  the 
number  of  the  load  class  to  be  used  by  the  current  pro¬ 
gram.  A  description  of  a  single  entry  in  the  program 
distribution  table  is  supplied  by  the  following  table 


layout 


TABLE  30 


TABLE  31  -  INTERRUPT  VECTOR  TABLE 


The  Interrupt  Vector  Table  can  contain  inter¬ 
rupt  vector  information  for  up  to  5  CPUs,  The  first  word 
in  an  interrupt  vector  table  entry  contains  the  number  of 
the  CPU  for  which  this  entry  applies.  The  sscond  word 
contains  the  number  of  the  operating  system  to  be  used 
by  this  CPU,  Words  3  through  22  contain  the  statement 
number  for  each  of  the  possible  20  interrupts  which  have 


been  defined. 


TABLE  31 

INTERRUPT  VECTOR  TABLE 
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TABLE  32  -  OPERATION  CODE  TABLE 


The  Operation  Code  Table  is  capable  of  con¬ 
taining  up  to  128  twelve  character  operation  codes  with 
their  associated  values.  This  table  is  loaded  by  the 
SOPCD  subroutine  before  the  actual  reading  of  input  data 
is  begun.  This  table  is  loaded  from  a  file  catalogued 
in  the  library  under  the  name  OPCDS/VERSl,  These  entries 
in  the  library  must  have  been  processed  by  ASXOOl  to 
insure  that  they  are  in  alphabetical  order.  This  table 
is  used  by  subroutine  SI  which  performs  a  binary  search 
looking  for  the  current  operation  code.  Words  1  and  2 
contain  the  operation  symbol.  Word  3  contains  the  value 
of  the  operation  code. 
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TABLE  32 

OPERATION  CODE  TABLE 

WORD 


TABLE  33  -  JOB  NAME  TABLE 


Th»  Job  Name  Table  contains  the  name  of  each 
worker  routine  entered  into  the  system  in  the  sequence 
in  which  it  appeared  in  the  system.  This  table  is  then 
written  out  for  use  by  the  assembler  statistical  analysis 
program.  Table  33  can  contain  up  to  100  job  names.  Words 
1  and  2  contain  the  12  character  job  names  and  word  3 
contains  the  starting  ordinal  file  number  for  this  job. 

A  description  of  a  single  entry  in  the  job  name  table 
is  supplied  in  the  following  table  layout. 


TABLE  33 


8^^ 


TABLE  34X  -  ORDINAL  FILE  NA>i£  TABLE 

The  Ordinal  File  Name  Table  contains  the 
names  of  all  ordinal  files  utilized  in  the  current  run. 
Words  1  and  2  contain  the  ordinal  file  name,  word  3 
contains  the  number  of  the  real  file  to  which  this 
ordinal  file  referred,  and  word  4  contains  the  number 
of  buffers  to  be  used  in  processing  this  ordinal  file. 
A  description  of  a  single  entry  in  the  ordinal  file 
name  table  can  be  seen  in  the  followinc;  table  layout. 


TABLE  35  -  0/S  MEMORY  ALLOCATION  TABLE 


The  operating  system  memory  allocation  table 
can  contain  5  pairs  of  entries  which  assign  up  to  5 
operating  system  programs  to  the  memories  in  which  they 
are  to  reside.  The  first  word  of  a  pair  contains  the 
operating  system  program  number.  The  second  word  of 
a  pair  contains  the  number  of  the  memory  in  which  that 
operating  system  is  to  be  placed.  The  data  in  the  0/S 
memory  allocation  table  comes  from  the  OS  statement. 

A  complete  description  of  the  O/S  memory  allocation 
table  may  be  seen  in  the  following  table  layout. 
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ASSEMBLER  MAIN  PROGRAM 

The  assembler  main  program  calls  the  first 
pass  subroutine,  ASMl,  first.  It  then  rewinds  the 
intermediate  and  local  dictionary  files.  The  second 
pass.  ASP,  is  then  called.  The  first  and  second  pass 
error  files  are  then  rewound.  The  CUR  tape  file  is 
then  closed.  The  error  pass  is  then  called. 
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ERROR  MESSAGE  FORMATTING  MAIN  PROGRAM 


This  routine  tests  and  prepaires  error  messages 
for  use  by  the  error  pass.  A  control  card  is  read  in 
containing  either  the  word  BUILD,  PRINT,  or  PUNCH.  If 
BUILD  is  present,  then  the  error  messages,  after  testing, 
are  written  out  onto  a  tape  in  CUR  format.  If  PUNCH  is 
present,  then  the  error  messages,  after  testing,  are 
punched  out  in  form  suitable  for  the  CUR  program.  If 
PRINT  is  present,  the  input  error  message  is  only  used 
for  testing.  Bach  input  message  is  transformed  into  a 
CUR  format  and  is  also  moved  to  a  FORTRAN  format  area, 
from  which  it  is  used  to  write  a  saiiq>le  error  message. 
Duplicate  error  messages,  by  number,  are  so  indicated. 
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CP-CODE  SEQTJEiTCING  PROGRAM 

This  program  reads  cards  containing  op-codes 
aaid  their  associated  value.  The  op-codes  can  be  presented 
in  any  order.  This  program  sorts  the  op-codes  aund  formats 
them  for  input  to  the  SOPCD  subroutine . 


3G 


0?-Cob~ 

SEQUElOii.'vIG  PROGftAiV'. 


!  RiGHT-PlLL  i 


OP-COD>£  r 


98 


SUBROUTINE  ASMl 

This  subroutine  makes  the  first  pass  through 
the  source  statements.  It  consists  of  two  phases. 

In  the  first  phase  the  hardware  configuration  description 
statements,  and  system  parameters  are  read  in,  processed, 
and  placed  in  appropriate  tables.  When  all  system  paraaneters 
have  been  processed,  the  tables  are  written  out  to  the 
simulator  input  file. 

The  second  phase  begins  with  the  receipt  of 
the  ASSEMBLY  statement.  All  operating  system  and  worker 
program  representations  must  follow  the  ASSEMBLY  statement. 
Furthermore,  all  macro  processing  takes  place  in  this 
phase.  In  this  phase,  statement  labels  and  local  equates 
are  placed  in  the  local  symbol  table.  A  local  symbol 
table  is  maintained  for  each  job  being  processed.  As 
each  job  is  ended,  this  symbol  table  is  written  out 
to  a  drum  storage  area.  After  examining  each  statement, 
expanding  macro  calls  as  required,  the  statements  are 
written  out  to  an  intermediate  file  on  the  drum,  from 
which  they  will  be  processed  by  the  second  pass. 
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SUBROUTINE  ASP 

This  is  the  assembler  second  pass  routine. 

It  processes  the  intermediate  file  records  into  assembler 
ii^ut  records.  It  is  a  table  driven  translator.  For 
each  statement,  there  is  a  table  entry.  In  the  entry 
there  is  a  field  to  indicate  v/hether  pre-operand  pro¬ 
cessing  is  required,  whether  post  operand  processing 
is  required,  operand  processing  for  each  of  the  six 
possible  operands  for  the  given  statement,  and  a  field 
containing  the  length  of  the  statement  as  it  is  used 
by  the  simulator.  As  each  statement  is  read  from  the 
intermediate  file  the  table  entry  is  consulted  and  the 
appropriate  pre,  post,  and  operand  processing  routines 
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SUBBOPTINE  CONV 

This  is  the  routine  which  converts  decimal 
representations  of  integers  which  are  left  justified 
in  the  fix  field  output  format  field  into  internal 
binary  integer  form.  The  routine  is  essentially  a 
right  to  left  scan  of  the  decimal  representation,  in 
which  each  digit  representation  is  converted  to  a 
binary  value  and  multiplied  by  its  positional  value, 
and  then  added  into  a  value.  After  all  digits  have 
been  scanned,  the  net  value,  representing  the  binary 
value  of  the  decimal  representation,  is  returned. 
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SUBROUTJKlE  CONV 
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SUBROUT/ NE  ERPASS 
(ERROR  PASS ) 
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SUBROUTINE  EVAL 


This  routine  evaluates  operands  which  may 
be  either  a  decimal  representation  of  a  constant,  a 
local  equate,  or  a  glooal  equate.  A  test  on  the  first 
character  is  performed  to  see  if  it  is  numeric.  If 
it  is,  then  the  CONV  routine  is  called  which  converts 
it  to  internal  binary  form.  If  it  is  not  a  decimal 
representation  of  a  nvimber,  then  the  local  symbol  table 
is  searched  to  see  if  the  operand  is  a  local  equate. 

If  it  is,  the  associated  symbol  table  value  is  returned. 
If  it  is  not  a  local  equate,  then  the  global  symbol 
table  is  searched  to  see  if  it  is  a  global  equate.  If 
it  is,  then  the  associated  global  symbol  table  value 
is  returned. 


SUBRUrriNE  GGSYM 


This  routine  is  used  to  rind  the  table  value 
for  a  given  global  s}nBbol  in  the  global  s3rslbol  dictionary. 
The  global  synbol  is  hashed  into  a  value  froa  1  to  100 
by  calling  the  HA-SSI  routine.  This  table  entry  foras  the 
head  of  a  chain  through  the  syabol  table  entries  itself. 
This  chain  is  searched  for  the  syi^ol  and  t^'pe  of  the 
sysihol  being  searched,  olhen  the  sysbol  and  type  agree, 
the  si/nbol  value  is  then  returned  as  the  output  of  the 


subroutine 


SUBROUTINE  GLSYM 


This  routine  is  used  to  find  the  table  value 
xor  a  given  local  synbol  in  the  local  syabol  dictionaory 
The  local  synibol  is  hashed  into  a  value  from  1  to  100 
by  calling  the  HASH  routine.  This  table  entry  forms  th 
head  of  a  chain  through  the  sy^ol  .  able  entries  itself 
This  chain  is  searched  for  the  syiabol  and  type  of  the 
S3rs2bol  being  searched.  When  tfie  symbol  and  type  agree, 
the  s3a3bol  value  is  then  returned  as  the  output  of  the 


subroutine 


SUBROUTIKE  HASH 

This  routine  hashes  a  name  in  the  fix  field 
output  area  into  an  integer  in  the  range  of  1  to  90. 

The  number  of  pairs  of  characters  in  this  s3nnbol  are 
co3^uted.  The  pairs  are  then  added  together  and  their 
average  value  found.  A  shift  and  division  sure  performed 
and  a  random  nuaiber  between  the  range  of  1  cuid  90.  This 
number  is  then  retuxned  as  the  hash  value  of  the  s3n2bol. 


SUBROUTINE  NERR 


This  routine  is  the  normal  error  handler.  It 
accepts  as  input  an  error  number,  a  statement  label  to 
which  it  xvill  return,  and  two  words  which  are  to  be 
included  in  the  error  message  when  it  is  finally  printed 
out  by  the  error  pass.  This  routine  writes  the  error  to 
the  current  error  file  and  turns  on  the  master  error 


-switch 


SUBROUTINE  PAGE 

This  routine  is  ceiled  whenever  ir  is  desired 
to  move  to  a  new  page  of  printout.  A  title  is  printed 
at  the  top  of  each  page .  A  count  is  maintained  of 
the  number  of  pages  printed  out.  This  page  number 
also  appears  on  the  same  line  as  the  title.  The  routine 
resets  the  line  counter  to  a  maximum  of  46  lines  per 
page. 


SUBROUTINE  PGSYM 


This  routine  places  symbols  into  the  global 
symbol  table.  Before  placing  any  symbol  into  the  global 
symbol  table,  an  attei?pt  is  made  to  see  if  that  symbol 
is  already  there,  avoiding  duplicate  entries.  If  the 
entry  is  not  in  the  symbol  table,  then  the  hash  table 
entry  for  that  symbol  is  consulted  and  the  chain  followed 
looking  for  the  last  entry  on  the  chain.  When  the  lai'"^ 
entry  is  found,  the  new  symbol  is  appended  to  the  chain. 
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SGSSOUTINE  PLSYM 


This  routine  places  symbols  into  the  local 
syiobol  table.  Before  placing  any  symbol  into  the  local 
s3ra>bol  table,  an  attempt  is  made  to  see  if  that  S3noQbol 
is  already  there,  avoiding  dijplicate  entries.  If  the 
entry  is  not  in  the  symbol  table,  then  the  hash  table 
entry  for  that  sjrmbol  is  consxilted  and  the  chain  followed 
looking  for  the  last  entry  on  the  chain.  When  the  last 
entry  is  found,  the  new  ssnnbol  is  appended  tc  the  chain. 
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SUBROUTINE  RBLK 

This  routine  chainges  right  hand  zeroes  to 
blanks  in  che  first  word  of  the  input  area  used  to 
read  from  the  library.  This  padding  with  blanks  is 
performed  prior  to  searching  the  library  for  the  given 
entry  point. 
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SUBROUTINE  RZRO 

This  routine  is  used  to  right -fill  a  two  word 
symbol  in  the  fix  field  output  airea  with  zeroes. 
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SUBROUTINE  SA 

This  subroutine  initializes  phase  2  by  filling 
common  with  zeroes,  filling  the  op-code  table  with  all 
’Z’s,  filling  the  title  with  blanks,  setting  constants, 
and  storing  global  symbols. 
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SGBROUTINE  SAl 


-Ihls  routine  reads  input  xrom  the  Biacro 
input  file  in  fixed  fields  format.  It  also  recon¬ 
structs  the  statement  in  preparation  for  printing  out. 
Upon  reaching  the  end  of  the  macro  input  file  it  sets 
am  end  of  file  indicator. 


SUBROUTINE  SA2 


This  routine  reads  source  statements  thrt 
have  been  placed  on  the  copy  input  file  following 
execution  of  a  copy  statement.  Each  call  on  this 
subroutine  causes  one  record  to  be  read  from  the 
copy  input  file.  At  the  end  of  the  file,  an  end  of 


file  switch  is  set 


SUBROUTINE  SA3 

This  routine  reads  source  statements  from 
the  standard  input  file.  Each  call  on  this  routine 
causes  one  record  to  be  read  from  the  standard  input 
file.  The  input  is  stored  in  both  packed  and  unpacked 
forms  for  further  processing.  When  the  end  of  file  is 
reached,  an  end  of  file  switch  is  set. 
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SUBROUTINE  SA4 

This  routine  transforms  the  free  field  format 
input  into  a  fixed  field  form  ^lsed  for  processing  by 
all  other  routines  in  the  first  pass.  Within  this 
subroutine,  there  are  separate  routines  for  processing, 
comment  cards,  macro  definitions,  special  op-code?, 
normal  op-codes,  continuation  cares,  symbols  .followed 
by  asterisks,  symbols  p-receuod  .)y  ampersands/  and 
statement  label  variables.  This'  routine  has  a  secondary  . 
^ntry  point,  SA5,  which  .is  called  whenever  a  continuation 
card  is  to  be  tranrferaed  tnto  fixed  field  output' form. 
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SUBROUTINE  SA6 


This  routine  is  used  to  write  records  to 
the  intermediate  assembly  file.  It  is  used  by  the 
ASMl  routine.  The  first  word  of  each  record  contains 
a  count  of  the  number  of  words  in  the  record.  The 
records  are  therefore  of  variable  length. 


SUBROUTINE  SA7 


This  routine  is  used  by  the  ASMl  routine  to 
print  the  input  statements.  The  routine  provides 
two  auxiliary  functions.  The  first  of  these  is  that 
a  check  is  made  of  the  number  of  lines  written  on  the 
page.  If  the  number  of  lines  has  been  used  up,  the 
PAGE  routine  is  called.  The  second  auxiliary  function 
consists  of  a  check  to  see  if  the  input  is  coming  from 
the  macro  input  file,  corresponding  to  the  expansion 
of  a  macro  call,  in  which  case  a  G  precedes  the  print 
out  of  the  statement. 


SUBROUTIl^L  5A8 


This  routine  prints  out  the  hardware  defin¬ 
itions  at  the  end  of  the  first  phase  of  the  first  pass 
subroutine.  The  CPU,  MEMORY,  CHANNEL,  and  DEVICE 
definitions  are  printed  out  on  the  system  printer. 


SU3R0UTIME  SA9 


This  routine  is  called  by  the  ^irst  pass  sub¬ 
routine  to  output  hardware  eoid  progrcon  definition  tables 
to  the  simulator  input  tape.  The  queue  tables,  load 
class  tables,  run  class  tables,  real  file  tables, 
program  distribution  table,  table  dump  control  table, 
ourput  statistics  control,  output  interrupt  vector 
table,  output  memory  assignment  table,  are  written  to 
the  simulator  input  tape.  In  addition,  the  job  name 
and  ordinal  file  name  blocks  are  written  to  tne  statis- 


SUBROUTIXS  SERR 

This  is  the  error  routine  for  the  fix  fields 
routine.  It  does  the  sar.e  functions  as  the  NERR  routine, 
only  it  automatically  computes  the  current  location  of 
one  fix  fields  scan  and  includes  the  current  tivo  v;ords 
ro  be  written  onro  the  error  file.  These  words  v/ill 
rhen  be  used  in  the  error  message  as  it  is  printed  out 
by  the  error  pass. 

OX . 


The  master  error  switch  is  turned 


SUBROUTINE  SMACRO 


This  routine  is  called  to  process  a  macro 
Call  appearing  in  job  source  input.  This  routine 
expands  the  macro  call,  processing  nested  macro  calls 
as  they  occur,  and  places  the  generated  statements 
into  a  macro  input  file.  A  switch  is  then  set  which 
signals  the  first  pass  subroutine  that  is  now  to  taXe 
its  input  from  the  macro  input  file. 

The  SMACRO  subroutine  first  moves  the  macro 
call  to  a  prototype  area.  It  then  performs  some  house  - 
keeping,  initializing  itself  and  setting  values  for 
macro  numbers  which  must  be  appended  to  statement  labels. 
The  library  is  then  searched  for  the  macro  call  naone 
and  the  macro  is  read  from  the  library  and  stored  on 
the  macro  input  file.  Statement  label  variables,  and 
statement  labels  requiring  macro  numbers  to  be  appended 
are  processed  as  required. 
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SUBROUTINE  SOPCD 

This  routine  searches  the  library  for  the 
op-codes.  After  finding  them,  it  reads  them  into  the 
op-code  table  in  memory  where  it  is  used  for  processing 
by  the  first  pass,  i^ter  reading  the  formatted  and 
packed  op-codes  and  loading  them  unpacked  into  the 
table,  the  remainder  of  the  table  is  filled  with  all 
nines  to  insure  a  correct  binary  search  of  the  table 


for  op-codes 
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SUBROUTINE  SXl 

This  routine  processes  CPU  definitions. 
Within  this  routine,  a  test  is  made  of  the  second 
operand,  which  indicates  whether  the  CPU  definition  is 
to  be  found  in  the  library,  or  if  it  is  in  the  input 
stream,  whether  it  is  to  be  catalogued  or  not.  The 
CPU  definition  is  then  read  from  the  library  or. from 
the  input  stream  as  required,  and  placed  into  the  ' 
appropriate  table  in  common.  The,  CPU  definition  is 
printed  out  as  it  is  r^'ceived.  A  count  is  maintained 
of  the  nvimber  of  such  CPU  definitions  received.  A 
check  is  made  to  determine  if  the  maximum  number  has 


been  exceeded 
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SUBROUTINE  SX2 

This  routine  processes  memory  definitions. 
I^e  second  operand  is  checked  to  see  whether  the 
definition  is  in  the  library  or,  if  it  is  in  the 
input  stream,  whether  it  is  to  be  catalogued  or  not. 
The  memory  definition  is  then  obtained  from  the  appro¬ 
priate  input  file,  printed  out,  and  stored  in  an  appro 
priate  table  in  common.  A  count  is  made  of  the  n\iiia>er 
of  memory  definitions.  A  check  is  made  to  see  If  the 
number  of  memory  definitions  has  exceeded  the  maximum 
permitted. 
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-~UB?OUTINE  SX3 

This  routine  processes  channel  definitions. 
The  second  operand  is  checked  to  see  whether  the 
definition  is  in  the  library  or,  if  it  is  in  the 
input  stream,  whether  it  is  to  be  catalogued  or  not. 

The  channel  definition  is  then  obtained  from  the  appro¬ 
priate  input  fi.le,  printed  out,  and  stored  in  an  appro¬ 
priate  table  in  common.  A  count  is  made  of  the  number 
of  channel  definitions.  A  check  is  made  to  see  if  the 
number  of  channel  definitions  has  exceeded  the  maximum 
permitted., 
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SUBROUTINE  SX4 


This  routine  processes  a  device  definition 
statement.  In  this  routine,  the  second  operaoid  is 
checked  first  to  see  if  it  indicates  that  the  device 
definition  is  to  be  taken  from  the  library,  or  if  it 
is  in  the  input  stream,  whether  it  is  to  be  catalogued 
or  not.  The  device  definition  is  then  read  from  the 
appropriate  input  file.  It  is  then  re-read  into  the 
device  definition  table.  If  the  device  defintion  is 
to  be  catalogued,  a  check  is  made  to  see  if  the  device 
ID  is  already  in  use.  If  it  is,  an  error  is  written. 

If  not,  a  new  file  is  created  for  the  device  definition 
and  the  device  defintion  is  catalogued. 


DtCRE’MCfJT 
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SUBROUTINE  SX5 


This  routine  processes  the  configuration 
card.  The  second  operand  is  checked  to  see  whether 
the  configuration  is  in  the  library  or,  if  it  is  in 
the  input  stream,  whether  it  is  to  be  catalogued  or 
not.  The  next  configuration  card  is  then  obtained 
from  the  appropriate  input  file,  printed  out,  and 
stored  in  an  appropriate  table  in  common.  As  each 
subsequent  input  is  read  in,  this  routine  calls  other 
subroutines  for  further  processing  according  to  whether 
the  input  is  for  CPU,  MEM,  CHAN,  CTL,  or  DEV  config¬ 
uration  information.  This  routine  also  checks  for  the 
CCXFIG-END  card,  at  which  point  a  return  is  made  to  the 
first  pass  subroutine,  AS!U. 
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291 


SUBROUTI^E  SX51 

This  routine  processes  the  CPU  configuration 
card.  It  first  checks  the  CPU  definition  table  to 
determine  if  the  CPU-ID  is  valid.  After  finding  the 
name,  it  is  placed  into  the  global  symbol  table.  Some 
additional  housekeeping  is  performed. 
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SUBROUTINE  SX52 


This  routine  processes  the  memory  config¬ 
uration  card.  The  MEMORY-ID  table  is  searched  to 
verify  that  the  MEMORY-ID  is  valid.  A  test  is  made 
to  see  that  the  maximum  number  of  memory  names  is  not 
ej:ceeced.  A  test  is  made  to  see  if  the  associated 


CPU  name  is  valid 


SUBROUTINE  SX53 


This  routine  processes  the  channel  config¬ 
uration  card.  The  CHANNEL- ID  table  is  searched  to 
verify  that  the  CHANNEL- ID  is  valid.  A  test  is  made 
to  see  that  the  maximum  nximber  of  channel  names  is 
not  exceeded.  A  test  is  made  to  see  if  the  associated 


CPU  name  is  valid 
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SUBROUTINE  SX54 


This  routine  processes  the  control  config¬ 
uration  card.  The  CTL-ID  table  is  searched  to  verify 
that  the  CTL-ID  is  valid,  A  test  is  made  to  see  that 
the  maximum  number  of  control  names  is  not  exceeded, 

A  test  is  made  to  see  if  the  associated  CPU  name  is 


valid 


SUBROUTINE  SX55 


This  routine  processes  the  device  config¬ 
uration  card.  The  first  step  is  to  resolve  the  SEIZE 
NCSEIZE  operand.  A  check  is  then  made  to  verify  that 
The  device  definition  is  valid.  A  check  is  made  to 
see  mat  the  number  of  device  definitions  does  not 
exceed  the  maximum.  The  device  name  is  then  placed 
in  the  global  symbol  table.  The  control  names  are 
resolved  and  appropriate  housekeeping  is  performed. 
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SUBROUTINE  SX56 


This  routine  processes  the  CONFIG-END  card. 
Upon  receiving  this  card,  the  hardware  configuration 
tables  built  up  by  other  subroutines  are  written  out 
onto  the  simulator  input  tape.  A  return  is  then  made 
to  the  first  pass  routine. 
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SUBROUTINE  SX6 

This  routine  processes  the  TF  definition 
card.  The  first  step  is  to  test  whether  a  TF  definition 
is  already  in  progress.  If  it  is,  an  error  is  declared. 
If  not,  a  TF  definition  is  declared  to  be  in  progress. 

A  check  is  then  made  for  the  device  name  and  number  of 
files.  The  next  anticipated  op-code  is  set  to  be  TABLE. 
The  row  counter  is  then  '.eroed,  and  a  return  is  made  to 


the  calling  program 
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SOBROOTINE  SX7 

Ibis  routine  processes  the  TABLE  stateaects. 
The  row  counter  is  increnented,  and  a  test  is  aade  to 
see  if  there  are  aore  lows  than  files.  The  output  area 
is  then  zeroed.  The  device  nuaber,  row  count,  and 
nuaiber  of  files  are  stor^  in  an  appropriate  table. 

The  table  entries  are  then  converted  using  the  CQNV 
routine.  The  table  is  then  written  out  to  the  sia- 
ulator  input  tape. 
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SUBROUTINE  SX8 

This  routine  processes  the  TP-END  statement. 
If  no  table  statements  have  been  received,  an  error  is 
written.  A  switch  is  set  to  indicate  all  table  &'tate- 
ments  have  now  been  received.  A  return  is  then  made  to 
the  assenibler  first  pass  routine. 
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SUBROUTINE  SX9 

This  routine  is  used  to  process  the  Q-DEF 
statement.  It  first  tests  to  see  if  the  queues  have 
already  been  received.  If  they  have,  an  error  is  written 
If  not,  a  switch  is  set  to  indicate  that  queues  may  now 
be  received.  The  next  anticipated  op-code  is  set  to  be 
the  QUEUE  statement,.  A  return  is  then  made  to  the 
assembler  first  pass  subroutine. 


32S 

SUBROUTINE  SXIO 

This  routine  processes  the  queue  statement. 

It  places  a  queue  name  into  the  global  symbol  table r 
After  performing  some  housekeeping  functions,  a  queue 
name  is  moved  to  the  queue  table.  The  next  anticipated 
op-code  is  set  to  be  either  another  QUEUE  or  a  Q-END 
statement.  A  count  is  made  of  the  total  number  of 
queue  entries  and  a  test  is  made  to  see  if  the  meocimum 
number  has  been  exceeded. 
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SUBROUTINE  SXll 

The  IQR  switch  is  set  to  2  indicating  that 
all  queues  have  been  received.  This  routine  is  called 
when  the  Q-END  statement  is  received. 
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SUBROUTINE  SX12 

This  routine  processes  the  PILE-DEP  statement. 
A  test  is  made  to  see  if  the  file  definitions  have 
already  been  received.  If  they  have,  an  error  is 
declared.  If  not,  a  switch  is  set  indicating  that 
files  are  now  to  be  received.  The  next  op-code  switch 
is  set  to  accept  RP  statements. 
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SUBROUIINE  SXU 

This  routine  processes  RP  statements.  A 
test  is  made  to  see  if  file  definitions  are  now  in 
progress.  A  test  is  made  to  see  if  the  maximxun  number 
of  files  is  being  exceeded.  The  device  name  is  re¬ 
solved,  the  file  name  and  converted  operands  are  st'  red 
in  an  appropriate  table.  The  next  op-code  is  set  to 
be  either  another  RP,  RPC,  or  PILE-END  statement. 
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SUBROUTINE  SX14 


This  zoutlns  procsssss  the  RPC  st&teaent. 

A  test  is  first  Ka4e  to  see  if  the  file  definition 
is  in  progress.  A  check  is  made  to  see  that  the 
nsxiavim  nunber  of  files  has  not  been  cscceeded.  A 
test  is  made  to  see  if  the  c'*i  file  name  is  valid.  ■ 
The  neT<f  file  name  is  put  into  the  file  table  and 
the  global  syidt>ol  table.  The  device  name  is  resolved 
into  a  device  number  and  stored  in  the  file  table. 

The  next  expected  op-codes  are  set  to  be  RP,  RPC,  or 


file  end 
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SUBROUTINE  SX15 


This  routine  processes  the  file  end  statement 
Its  fvinctions  are  to  clear  the  next  anticipated  op-code 
area,  and  to  set  a  switch  indicating  that  file  defin¬ 
itions  have  been  received.  A  return  is  then  made  to 


the  first  pass  subroutine 
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SUBROUTINE  SX16 


This  routine  processes  the  load  class  defin¬ 
ition  statement.  A  test  is  made  to  see  if  the  load 
class  information  has  already  been  received,  if  it 
has,  an  error  is  written.  Otherwise,  the  load  class 
switch  is  set  to  indicate  that  load  class  information 
nay  now  be  received.  The  next  anticipated  op-code  if, 
set  to  be  the  LOAD  op-code.  A  return  is  made  to  the 
first  pass  subroutine. 
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SUBROUTINE  SX17 


This  routlns  processes  the  LOAD  statement. 

A  test  is  made  to  see  if  the  load  class  information 
may  now  be  received.  The  run  class  identification  is 
then  checked  to  see  if  it  is  within  range,  and  if  it 
has  already  been  used.  The  CPU>IDs  associated  with 
this  load  class  are  then  identified  by  using  the  global 
syn^ol  table.  Information  is  stored  in  an  appropriate 
table.  The  next  anticipated  op-code  is  set  to  be 


either  LOAD  or  LC-BND 
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SUBROOTINB  SX18 


This  routine  processes  the  LC-BND  statement. 
This  routine  indicates  that  the  end  of  the  load  class 
data  has  been  received.  This  is  indicated  by  setting 
a  switch.  A  return  is  then  made  to  the  first  pass  sub¬ 


routine 
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SUBROUTINE  SX19 


This  routine  processes  the  run  class  defin¬ 
ition  card.  A  tost  is  first  made  to  see  whether  the 
run  class  information  has  already  been  accepted.  If 
it  has,  then  an  error  is  written.  Otherwise,  a  switch 
is  set  to  indicate  that  run  class  definitions  may  now 
be  received.  The  next  anticipated  op-code  is  set  to 
RUN.  A  return  is  made  to  the  first  pass  subroutine. 
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SUBROUTINE  SX20 

This  routine  processes  the  RUN  statement. 

A  test  is  first  made  to  see  whether  run  definitions 
may  now  be  accepted.  If  not,  an  error  is  written. 

The  CPU  names  that  are  assoijiated  with  this  run  card 
are  identified  by  use  of  the  global  symbol  table.  The 
identity  of  the  CPUs  is  stored  in  an  appropriate  table 
The  next  op-code  is  set  to  be  either  RUN  or  RC-END. 
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SUBRCXJTINE  SX21 

This  routine  processes  the  RC>END  statement. 
This  statement  denotes  the  end  of  the  RUN  CLASS  defin 
it ion  information.  This  condition  is  indicated  by 
setting  a  switch.  A  return  is  then  made  to  the  first 
pass  subroutine o 
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SUBROUTINE  SX22 


This  routine  processes  the  table  control 
statement.  A  check  is  first  made  to  see  whether  or 
not  a  table  control  statement  has  already  been  accepted. 
If  it  has,  an  error  is  written.  If  not,  a  switch  is 
set  to  indicate  that  the  table  control  statement  has 
been  accepted.  A  test  is  made  to  see  whether  or  not 
a  normal  condition  is  ON  or  OFF.  Subsequent  operands, 
denoting  tables,  are  identified  and  their  print  status 
is  set.  A  return  is  made  to  the  first  pass  subroutine. 
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SUBROUTINE.  SX23 


This  routine  processes  the  statistics  control 
statement.  A  test  is  first  made  to  see  whether  or  not 
the  statistics  control  ^rtatement  has  "xlready  been  re¬ 
ceived.  If  it  has,  an  error  condition  is  raised.  If 
not,  a  switch  is  set  to  Indicate  that  the  statistics 
control  statement  has  been  received.  A  test  is  then 
made  to  see  whether  the  normal  condition  for  printing 
out  a  statistics  table  is  Qi^  or  OFF,  Subsequent  oper¬ 
ands,  denoting  statistics  tables  to  be  printed,  are 
identified  and  their  print  status  is  set.  A  return 
is  then  made  to  the  first  pass  subroutine. 
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SUBROUTINE  SX24 


This  routine  processes  the  STATISTICS  state¬ 
ment.  This  routine  obtains  the  first  and  second  oper¬ 
ands  denoting  the  statistics  interval  and  the  number 
of  such  intervals  to  be  used  during  this  simulation, 
and  stores  them  in  appropriate  fields.  A  return  is 
then  made  to  the  calling  subroutine. 
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SUBROUTINE  SX25 


This  routine  processes  the  ASSEMBLY  statement. 
It  first  calls  SA8  which  is  used  to  print  the  hardware 
defintions.  It  then  writes  several  blocks  of  data  to 
the  statistics  file.  These  blocks  contain  file  names, 
device  names,  channel  names,  control  name  blocks,  queue 
name  blocks,  and  memory  name  blocks.  Common  is  then 
cleared.  The  program  distribution  table  is  then 
initialized.  The  load  class  and  run  class  tables  are 
also  initialized.  The  assembly  switch  is  set  OFF  to 
permit  processing  of  worker  program  routines.  A  test 
is  then  made  to  see  whether  the  operand  in  the  assembly 
statement  was  NOPRINT,  and  the  appropriate  print  switch 
setting  is  made.  A  return  is  then  made  to  the  first 


pass  subroutine. 
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SUBROUTINE  SX26 


This  routine  processes  the  TITLE  statement. 
The  next  card  is  read  from  the  input  stream  and  its 
contents  stored  in  the  page  title  area  of  memory.  The 
printer  is  then  advanced  to  the  top  of  a  new  page  and 
the  title  printed  out  there.  A  return  is  then  made 
to  the  first  pass  subroutine. 


SUBROUTINE  SX27 


This  routine  processes  the  GEQU  statement. 
This  statcnent  is  used  to  define  global  equates.  The 
first  operand  is  converted  to  internal  binary  form, 
and  the  statement  label  and  this  value  are  stored  in 
the  global  syaibol  table  as  a  global  equate.  A  return 
is  then  made  to  the  calling  subroutine. 
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SUBROUTINE  SX28 


This  routine  processes  the  LEQU  statement. 


A  test  is  first  made  to  see  whether  a  job  statement 


has  preceded  this  LEQU  statement.  If  not,  an  error 
is  written.  Otherwise,  the  first  operand  is  converted 
to  internal  binary  form,  and  this  value  and  the  state- 


Stored  m  the  locax  symuox  taole  as  a 


local  equate,  A  return  is  then  made  to  the  first  pass 
subroutine. 


SUBROUTINE  SX29 


This  routine  processes  the  JOB  statement.  A 
test  is  made  to  see  whether  this  statement  has  occurred 
in  the  middle  of  another  job.  If  it  has,  an  error  is 
written.  If  not,  a  switch  is  set  to  indicate  thax  a 
job  has  been  begun.  The  number  of  jobs  is  then  incre¬ 
mented  by  one.  A  test  is  then  made  to  see  whether  the 
number  of  jobs  received  has  exceeded  the  maximum.  The 
job  name  is  stored  in  the  global  symbol  table.  Some 
internal  housekeeping  is  then  performed.  The  local  job 
statement  number  is  then  set  to  zero.  A  return  is  then 
made  to  the  first  pass  subroutine. 
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SUBROUTINE  SX30 


This  routine  processes  the  OF  statement.  The 
number  of  OF  statements  received  is  incremented  by  one. 
The  OF  name  and  its  numeric  value  are  then  stored  in 
the  local  symbol  table.  The  op-code  switch  is  set  to 
81  denoting  an  OF  statement  has  been  received.  A  return 
is  then  made  to  the  first  pass  subroutine. 


SUBROUTINE  SX31 


This  routine  processes  the  END  statement.  A 
check  is  first  made  to  see  whether  a  job  is  in  progress. 
If  not,  an  error  message  is  written.  The  job  switch  is 
then  set  to  zero,  denoting  that  no  job  is  in  progress. 
The  job  identification  number,  the  local  hash  table, 
and  the  local  symbol  table  are  then  written  out  onto 
file  number  8.  The  ordinal  file  counter  is  reset  to 
zero.  The  op-code  switch  is  then  set  to  86,  denoting 
the  fact  that  an  END  statement  has  been  received.  A 
return  is  then  made  to  the  first  pass  subroutine. 
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SUBROUTINE  SX32 


Th's  routine  processes  the  COPY  statement. 
The  copy  name  is  moved  to  the  CUR  output  area  where 
it  is  used  to  search  for  the  copy  file  name.  If  the 
copy  file  name  is  not  fovind  an  error  is  written.  If 
it  is  found,  then  the  file  is  copied  from  the  library 
into  the  copy  input  file  A  switch  is  then  set  to 
indicate  that  there  is  input  in  the  copy  file,  auid 
a  return  is  made  to  the  main  first  pass  routine. 


SUBROUTINE  SX33 

This  routd''e  processes  the  MSET  statement. 

The  statement  variables,  occurring  as  operands  in  the 
MSET  statement,  are  checked  for  proper  format.  The 
table  of  active  statement  variables  is  then  searched 
to  see  if  there  is  a  match  for  each  operand  in  the 
MSET  statement.  If  there  is  a  match,  the  new  value  is 
stored  in  the  table  and  the  count  zeroed.  Otherwise, 
an  empty  slot  is  searched  for,  and  the  stextement 
variable  placed  in  this  slot  with  its  value  and  zero 
count.  A  check  is  made  to  see  that  no  more  than  ten 
statement  variables  are  active  at  any  one  time.  A 
return  is  then  made  to  the  calling  subroutine. 


SUBROUTINE  SX35 


This  routine  processes  the  IV  statement.  The 
global  symbol  table  is  searched  for  the  CPU  name,  and 
the  interrupt  vector  is  searched  for  the  old  interrupt 
name.  The  new  interrupt  name  is  then  stored  in  the 
interrupt  table. 


SUBROUTINE  SX36 


This  routine  processes  the  RCV  statement. 

The  global  s3^bol  table  is  searched  for  the  CPU  name 
and  its  associated  value.  The  load  class  number 
xvhich  is  the  second  operand  in  the  RCV  statement,  is 
stored  along  with  the  CPU  value  in  the  job  distribution 


SUBROUTINE  SX37 


This  routine  is  used  to  store  the  job  number 
and  memory  name  value  into  the  memory  assignment  table, 
and  to  process  interrupt  names  in  the  interrupt  table. 

This  routine  is  called  when  the  OS  statement  is  encountered. 
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SUBROUTINE  SI 

The  f line t ion  of  this  subroutine  is  to  resolve 
op-codes.  Resolution  implies  the  following.  A  binary 
search  of  a  table  containing  all  of  tL'  valid  op-codes 
is  made  to  see  if  the  op-code  contained  in  the  given 
statement  is  in  the  table.  If  it  is,  a  switch  is  set 
indicating  a  normal  op-code.  If  it  is  not  in  the 
table,  then  a  switch  is  set  to  indicate  this  fact. 

If  an  op-.code  is  not  in  the  table,  it  may  either  be 
an  invalid  op-code  or  a  macro  op-code.  The  deter¬ 
mination  of  which  is  the  case  will  be  made  by  the 
SMACRO  routine. 


FORTRAN  I/O  UNIT  ASSIGNMENTS 


FILE 

CARD  reader 
PRINTER 

ASSEMBLER  INTERMEDIATE  FILE 

LOCAL  SYMBOL  TABLE  FILE 

COPY  INPUT  FILE 

MACRO  FILE  A 

MACRO  FI^  B 

SECOND  PASS  OUTPUT 

FIRST  PASS  ERROR  OUTPUT 

SECOND  PASS  ERROR  OUTPUT 

CUR  FILE,  TAPE  'C 

NAME  FILES,  TAPE  ’B* 
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INTERMEDIATE  ASSEMBLY  FILE. 


The  Intermediate  Assembly  File  contains  the 
output  from  the  first  pass  and  the  input  to  the  second 
pass.  Records  on  the  intermediate  assembly  file  are 
variable  in  length,  ranging  from  five  words  to  23 
words.  The  first  word  in  each  record  contains  the 
length,  in  words,  of  the  current  record.  The  variable 
portion  of  an  intermediate  assembly  file  record  con¬ 
sists  of  statement  operands.  Since  S3  assembler  state¬ 
ments  may  have  from  0  to  6  operands,  a  record  in  the 
intermediate  assembly  file  contains  only  those  operands 
actually  present  in  the  current  statement. 

A  detailed  description  of  a  record  in  the 
intermediate  assembly  file  is  shown  by  the  following 


record  layout 
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FORTRAN  UNIT  7 


INTERMEDIATE  ASSEMBLY  FILE 


WORD 


1  , 

2 

3  - 

4 

5 

RECORD  LENGTH  IN  WORDS  1 

RECORD  CODE  | 

NUMBER  OF  OPERAxNDS—  1 

STATEMENT  NUMBER  1 

i 

OP-CD  g 

6 

OPERAND -1  PART  I  | 

7 

OPERAND -1  PART  II  | 

OPERAND  1  i 

8 

LENGTH  S  1 

21 

22 

23 


-4 

OPERAND -6 

PART 

OPERAND -6 

PART 

II  i 

1  OPERAND  E  1 

1  LENGTH  ^  8 

RECORD  CODES 
1  a  STATEMENT 


9999  =  END  OF  FILE 


LOCAL  SYMBOl.  TABLE  FILE 

Each  entry  in  the  Local  Symbol  Table  file 
consists  of  three  physical  records.  The  first  record 
contains  a  single  w?ord  which  provides  the  number  of 
the  job  which  created  this  local  symbol  table,  or  else, 
four  nines  to  indicate, end  of  file. 

The  second  physical  record  contains  a  variable 
number  of  five  word  local  symbol  table  entries.  The 
first  word  of  each  block  contains  a  count  of  the  number 
of  five  word  entries  contained  in  this  block.  Only 
those  symbols  obtained  from  the  current  job  are  written 
out  in  any  one  local  symbol  table  entry. 

The  third  physcial  record  is  the  90  word 
local  hash  table  which  provides  pointers  to  the  local 
symbol  table. 

A  detailed  description  of  the  local  symbol 
table  file  may  be  found  in  the  following  record  layout. 
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COPY  INPUT  FILE 


The  Copy  Input  File  consists  of  14  word 
records  exactly  as  they  are  obtained  from  the  library 
by  the  COPY  statement. 


A 


XACRO  FILES  A  &  B 


Macro  Files  A  &  B  are  used  by  the  SMACRO 


subroutine  during  the  processing  of  macro  instructions. 
Records  on  the  macro  files  are  in  the  exact  same  format 
as  they  appear  in  table  3-  The  first  v?ord  of  each 
record  indicates  the  total  number  of  words  in  the  current 
record.  The  records  <a:e  variable  since  there  may  be  a 
variable  number  of  operands  in  macro  statements. 


FORTR^W  UNITS  10  &  11 
MACRO  FILES  A  &  ii 


WORDS 


i 

1  j 

I  WORD  COUNT 

2 

XONJE^TS^OF. -  ...  1 

j 

3  1 

TABLE  3  UP  TO  \ 

j 

1 

4  1 

( 

WORD  COUNT  LIMIT  i 

FIRST  PASS  ERROR  OUTPUT 


The  First  Pass  Error  Output  file  is  written 
by  the  SERR  and  NERR  subroutines  Lach  record  consists 
of  four  words.  The  first  word  c  itains  the  number  of 
the  error  as  passed  to  the  error  subroutine.  The  second 
word  contains  the  current  statement  number  at  the  time 
the  error  was  detected.  The  third  and  fourth  words  of. 
each  error  record  may  contain  additional  information 
about  the  error  as  passed  to  the  error  handling  sub¬ 


routine 


MACRO  DEFINITION  FILE 

The  Macro  Definition  File  consists  of  14  word 
entries  in  the  PCF  library.  Since  a  single  st^-tement  in  ' 
a  aiacro  definition  may  require  more  information  tham 
may  be  stored  in  14  words,  a  single  statement  may  require 
more  than  one  record  in  this  file.  The  first  word  of 
each  record  in  the  macro  definition  file  contains  con¬ 
trol  information.  The  next  13  words  of  each  record 
consists  of  13  words  as  copied  from  table  3. 

The  first  six  bits  of  the  first  word  contain 
an  integer  value  of  one  as  required  by  the  EXEC  2 
system.  Bits  12  through  23  contain  the  number  of 
operands  in  the  macro  prototype  statement.  This  allows 
the  SMACRO  subroutine  to  insure  that  excess  operands 
are  not  used  in  calling  a  macro.  The  last  12  bits 
in  the  first  word  of  each  record  contains  a  record 
code.  Records  are  numbered  ordinally  for  each  state¬ 
ment  contained  in  the  macro  defi.nition  file.  A  comment 
record  is  indicated  by  a  record  code  99.  A  detailed 
description  of  macro  definition  file  records  follows. 
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macro  definition  file 
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STATEMENT 


TRAILER  REXRQ 


DIAGNOSTICS  FILE 


The  Diagnostics  Pile  consists  of  14  word 
records  in  tiie  PCF  library.  The  first  word  of  each 
record  consists  of  control  information.  The  next  l2 
words  contain  the  format  statement  used  to  print  the 
error  message.  The  last  word  contains  the  error  number 
in  the  first  12  bits. 

A  record  layout  for  the  diagnostics  file  is 


shown  on  the  following  page 
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